home *** CD-ROM | disk | FTP | other *** search
/ Aminet 33 / Aminet 33 - October 1999.iso / Aminet / dev / misc / Bump.readme < prev    next >
Encoding:
Text File  |  1999-09-06  |  4.2 KB  |  100 lines
  1. Short:    Automatic version generator, fully configurable. (+source)
  2. Author:   Robin Cloutman <rycochet@free4all.co.uk>
  3. Version:  3.4
  4. Type:     dev/misc
  5. Requires: AmigaOS 2.0+
  6.  
  7. This can easily replace C='s bumprev.
  8.  
  9. Features:
  10. · User defined output formats. (Unlike bumprev)
  11. · Remembers both version and revision. (Unlike bumprev)
  12. · Easy to use. (Unlike bumprev)
  13. · Output almost identical to bumprev. (Unlike... erm...)
  14. · Includes output for C, C++, ARexx, Asm.
  15. · Includes full source. (gcc version egcs-2.90.27 980315 (egcs-1.0.2 release))
  16. · Has installer.
  17. · 68000-68060 versions.
  18.  
  19. NOTE:
  20.   Although I have included the source code, I reserve full rights to it.
  21.   If you wish to add/change anything, then do it through me - I don't want
  22.   lots of versions hanging around...
  23.  
  24. Template:
  25.  Bump NAME/A,CODE/M,VERSION/S,SETVERSION/K/N,NO=NOREVISION/S,SETREVISION/K/N,QUIET/S
  26.  
  27.  NAME/A - the base name to use, will create "{NAME}_rev.ver" containing "{ver}.{rev}".
  28.  CODE/M - which code module(s) to use.
  29.  VERSION/S - bump the version (and set revision to 0).
  30.  SETVERSION/K/N - set the version to this.
  31.  NO=NOREVISION/S - don't bump the revision. (Useful for code generation only)
  32.  SETREVISION/K/N - set the revision to this.
  33.  QUIET/S - don't output any information for the user.
  34.  
  35. Code Generation:
  36.   All code generation files must reside in "S:" or the location pointed to by the "BUMPCODE" enviroment variable.
  37.   Each file has the name "bump-*", with the * replaced by the text in each CODE/M option.
  38.   Every line in the file starting with "##" can be -
  39.   · "## inform ..." Tell the user something.
  40.   · "## suffix ..." Close the current output file, and open another with the name "{NAME}_rev.{suffix}".
  41.   · "## filename ..." Close the current output file, and open another with this name.
  42.   · "## ..." anything else is a comment.
  43.   Replaced Symbols:
  44.   · "%n" is the name.
  45.   · "%v" is the version.
  46.   · "%r" is the revision.
  47.   · "%d" is the current date.
  48.   · "%t" is the current time.
  49.   · "%V" is the version of bump used (ie. bump 3.1).
  50.   · "%l?" is the length of the second symbol (ie. "%ld" is replaced by "8")
  51.   (see Bump-test)
  52.   NOTE: You can create more than one output file by using ##suffix and ##filename more than once!
  53.  
  54. History:
  55. · 1.0 - First effort.
  56. · 1.1 - Added rexx code.
  57. · 1.2 - Added locale support. (REMOVED)
  58. · 1.3 - Minor bug fixed...
  59. · 1.4 - Recompiled with "gcc version egcs-2.90.27 980315 (egcs-1.0.2 release)"
  60. · 1.5 - Automatically generate required code, only need switch first time. (REMOVED)
  61. · 2.0 - Made resident, otherwise no change.
  62. · 2.1 - Rewrote to make it easier to expand...
  63. · 3.0 - Changed template.
  64.         Made code output user-defined.
  65.         Removed locale support.
  66.         Removed automatic code generation.
  67. · 3.1 - Improved code parsing, user info and multiple files allowed.
  68. · 3.2 - Now searches "PROGDIR:", "S:", and $BUMPCODE for code.
  69. · 3.3 - Also searches {NAME} dir.
  70. · 3.4 - Code cleanup and new ## command (filename).
  71. · 3.5 - Recompiled with "gcc version egcs-2.91.66 19990314 (egcs-1.1.2 release)"
  72.         First Aminet release.
  73.  
  74.  
  75. ============================= Archive contents =============================
  76.  
  77. Original  Packed Ratio    Date     Time    Name
  78. -------- ------- ----- --------- --------  -------------
  79.        0       0  0.0% 11-Aug-99 16:57:12 +
  80.     3616    2373 34.3% 11-Aug-99 16:50:46 +Bump
  81.      568     289 49.1% 11-Aug-99 16:50:46 +Bump-asm
  82.      757     327 56.8% 11-Aug-99 16:50:46 +Bump-c
  83.      570     287 49.6% 11-Aug-99 16:50:46 +Bump-c++
  84.      554     274 50.5% 11-Aug-99 16:50:46 +Bump-e
  85.      476     259 45.5% 11-Aug-99 16:50:46 +Bump-rexx
  86.      498     233 53.2% 11-Aug-99 16:50:46 +Bump-test
  87.     3836    2510 34.5% 11-Aug-99 16:50:46 +Bump.020
  88.     3836    2510 34.5% 11-Aug-99 16:50:46 +Bump.030
  89.     3836    2512 34.5% 11-Aug-99 16:50:46 +Bump.040
  90.     3836    2513 34.4% 11-Aug-99 16:50:46 +Bump.060
  91.     6369    2085 67.2% 11-Aug-99 16:50:46 +Bump.c
  92.     1214     580 52.2% 11-Aug-99 16:50:46 +Bump.h
  93.     3069    1456 52.5% 11-Aug-99 16:50:46 +Bump.readme
  94.      654     243 62.8% 11-Aug-99 16:50:46 +Bump_rev.h
  95.        4       4  0.0% 11-Aug-99 16:50:46 +Bump_rev.ver
  96.     2366     908 61.6% 11-Aug-99 16:50:46 +Install
  97.     1264     378 70.0% 11-Aug-99 16:50:46 +makefile
  98. -------- ------- ----- --------- --------
  99.    37323   19741 47.1% 11-Aug-99 20:30:36   19 files
  100.